================================================================================
ORDER COPY HELPER (Копирование товаров заказа)
================================================================================

Аддон для CS-Cart 4.18.x

Позволяет быстро скопировать список товаров из заказа в буфер обмена для 
вставки в бухгалтерскую программу, Excel или Google Sheets. 

Также позволяет "растворить" стоимость доставки в стоимости последнего товара 
списка - доставка делится на количество товара и прибавляется к его цене.

================================================================================
ВОЗМОЖНОСТИ
================================================================================

• Отображает список товаров заказа в текстовом виде:
  Наименование → Количество → Цена

• Копирование списка одним кликом
  - Формат: данные разделены табуляцией
  - Удобно вставлять в Excel / Google Sheets / 1С

• Опция "Включить доставку в последний товар":
  - Стоимость доставки делится на количество последнего товара
  - Округляется вверх до целого числа
  - Прибавляется к цене последнего товара
  - Доставка в блоке итогов зачёркивается и становится серой
  - Показывается старый и новый ИТОГО

• Виджет встроен на страницу деталей заказа в админке
  - Расположен под блоками "Примечание покупателя" и "Примечание администратора"

• Не вызывает предупреждение "Изменения могут не сохраниться"
  - Использует класс cm-skip-check-item для исключения из отслеживания формы

================================================================================
ТРЕБОВАНИЯ
================================================================================

• CS-Cart версии 4.0 и выше (протестировано на 4.18.4)
• Доступ к админ-панели с правами установки аддонов
• Браузер с поддержкой Clipboard API (все современные браузеры)

================================================================================
УСТАНОВКА
================================================================================

Способ 1: Через админ-панель (рекомендуется)
--------------------------------------------
1. Зайдите в админ-панель CS-Cart
2. Перейдите: Модули → Управление модулями
3. Нажмите кнопку "+" (Загрузить модуль)
4. Выберите файл order_copy_helper.zip
5. Нажмите "Загрузить и установить"
6. Убедитесь что аддон активен (зелёный индикатор)

Способ 2: Вручную через FTP/SSH
---------------------------------
1. Распакуйте архив order_copy_helper.zip
2. Загрузите содержимое на сервер в корень сайта, сохраняя структуру:
   
   app/addons/order_copy_helper/
       addon.xml
   
   design/backend/templates/addons/order_copy_helper/hooks/orders/
       staff_only_note.post.tpl

3. Зайдите в админ-панель: Модули → Управление модулями
4. Нажмите шестерёнку → "Переустановить модули"
5. Найдите "Копирование товаров заказа" и активируйте

================================================================================
ИСПОЛЬЗОВАНИЕ
================================================================================

1. Откройте любой заказ в админ-панели
2. Прокрутите вниз до блока с примечаниями
3. Под ними появится виджет "Копирование товаров заказа"
4. В текстовом поле отображается список товаров
5. При необходимости отметьте галочку "Включить доставку в последний товар"
6. Нажмите кнопку "Скопировать товары"
7. Вставьте данные куда нужно (Ctrl+V / Cmd+V)

================================================================================
СТРУКТУРА ФАЙЛОВ
================================================================================

order_copy_helper/
├── app/
│   └── addons/
│       └── order_copy_helper/
│           └── addon.xml                    (конфигурация аддона)
└── design/
    └── backend/
        └── templates/
            └── addons/
                └── order_copy_helper/
                    └── hooks/
                        └── orders/
                            └── staff_only_note.post.tpl  (шаблон виджета)

================================================================================
ТЕХНИЧЕСКАЯ ИНФОРМАЦИЯ
================================================================================

Используемый хук:
  orders:staff_only_note (размещается после примечаний на странице заказа)

Классы CS-Cart:
  cm-skip-check-item - исключает элементы из отслеживания изменений формы

Формат данных:
  Наименование<TAB>Количество<TAB>Цена<NEWLINE>
  
Пример вывода:
  Товар ABC 250мл	10	700.00
  Товар XYZ прозрачный 10мл	5	600.00
  Товар 123 для теста 40г	3	750.00
  
  Доставка: 500.00 ₽
  ИТОГО: 15450.00 ₽

С включенной опцией "Включить доставку в последний товар":
  Товар ABC 250мл	10	700.00
  Товар XYZ прозрачный 10мл	5	600.00
  Товар 123 для теста 40г	3	917.00
  
  Доставка: 500.00 ₽ (зачёркнуто)
  Было: 15450.00 ₽
  ИТОГО: 15451.00 ₽

================================================================================
УДАЛЕНИЕ
================================================================================

1. Зайдите в админ-панель: Модули → Управление модулей
2. Найдите "Копирование товаров заказа"
3. Нажмите на название → "Удалить"
4. Подтвердите удаление

Файлы аддона будут автоматически удалены с сервера.

================================================================================
ПОДДЕРЖКА
================================================================================

Версия: 1.0.0
Совместимость: CS-Cart 4.0+
Протестировано: CS-Cart 4.18.4

Лицензия: свободное использование и модификация

================================================================================
ИЗМЕНЕНИЯ ПО ВЕРСИЯМ
================================================================================

1.0.0 (2025-12-09)
------------------
• Первый релиз
• Базовая функциональность копирования списка товаров
• Опция распределения доставки на последний товар
• Интеграция через хук orders:staff_only_note
• Исправлена проблема с предупреждением об изменениях формы

================================================================================
